home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / sillies / iconz2 / !IconZ%a02 / !Help next >
Text File  |  1994-09-25  |  5KB  |  93 lines

  1.                                    Funky IconZ 2
  2.                                    —————————————
  3. Funky Iconz: ?
  4. Funky IconZ 2: David G Jones
  5.  
  6. This module allows the Task Manager icon to be animated.
  7.  
  8. I don't know who created the original FunkyIconZ but it looked quite nice. Unfortunately it came as a BASIC application and disagreed with RiscOS3. This rectifies those problems and adds a number of useful features.
  9.  
  10.  
  11. —— Animations ———————————————————————————————————————————————————————
  12. IconZ2 consists of two components, the module and a set of animations. Each frame in the animation should be a sprite with the same dimensions. They are named "swch1", "swch2", etc to the last frame. There are no limits on the number of frames.
  13.  
  14. All of the frames should be in a single sprite file. An animation can be loaded into IconZ2 in one of three ways:
  15.  
  16. 1) At the same time as IconZ2 is loaded by including the file name as the parameter of the command. For example "*RMRun <Obey$Dir>.IconZ2 balls", where balls is the animation.
  17.  
  18. 2) Once IconZ2 has started if you drag the animation over to the Task Manager icon then the new animations will be loaded and used.
  19.  
  20. 3) From the command line "*IconZ2_Sprites balls" can be used, where balls is the name of the animation. As soon as the desktop is again operational the animation should start running.
  21.  
  22. If there is no animation loaded then the Task Manager icon will appear as normal.
  23.  
  24. The animation is loaded into IconZ2 memory rather than the Wimp SpritePool so this will not be cluttered up if you quit IconZ2.
  25.  
  26.  
  27. —— Update ———————————————————————————————————————————————————————————
  28. This allows the rate of animation to be changed. Specifically with the IconZ2_Update command you can set the delay in centiseconds between successive frames being shown. This is in the range of 1 - 255.
  29.  
  30. If you do not include a new delay value then the current value will be shown.
  31.  
  32. With a delay of 1 the toll on the desktop is not too great, and it is useful for gauging a rough idea of the any desktop load.
  33.  
  34.  
  35. —— Quitting IconZ2 ——————————————————————————————————————————————————
  36. To quit IconZ2 you should use the quit option from the Tasks display window. The Task manager icon should reappear as normal. Everything is OK
  37.  
  38. Unfortunately there are two anomalies if you detour from this process. They are both due to the somewhat circular nature in attempting to recreate the original icon so that the Task Manager will recognize it as so. In the future this will be tidied up.
  39.  
  40. 1) If you RMKill the IconZ2 module rather than Quitting, then the Task Manager icon will not reappear. Obviously this will impair access to the Task Manager facilitites, though it will still respond to F12 key presses. If the desktop is Shutdown/Exitted in this state then the Task Manager will barf before dropping out finally into the command line. This is because it expects its icon to be on the icon bar. If you reload IconZ2 though everything will return to normal.
  41.  
  42. 2) IconZ2 will quit in response to receiving a PreQuit wimp message. If the shutdown process is aborted then depending on the order of the tasks IconZ2 may well have quit already, even though it should still be alive. Everything will be left in a stable state, but obviously if you wish IconZ2 facilitites to still be operational then you will have to reload it.
  43.  
  44. Basically IconZ2 should never destroy anything. If you wish to terminate it then use the wimp Quit facilitites and all will be fine.
  45.  
  46.  
  47. —— Commands —————————————————————————————————————————————————————————
  48. IconZ2 supplies a number of commands:
  49.  
  50. ==> Help on keyword IconZ2
  51. Module is: IconZ2          0.06 (09 Sep 1994) © David G Jones
  52.  
  53. Commands provided:
  54. IconZ2_Update   IconZ2_Sprites
  55.  
  56. It has help on:
  57. IconZ2_Author
  58.  
  59. ==> Help on keyword IconZ2_Update
  60. IconZ2_Update controls the delay between each frame in the animation. If no delay is given then the current value is shown. All delays are in
  61. centiseconds within the range 1 - 255.
  62. Syntax: *IconZ2_Update [<delay>]
  63.  
  64. ==> Help on keyword IconZ2_Sprites
  65. IconZ2_Sprites will load the spritefile filename into IconZ. This contains a number of sprites which are the separate frames in the animation. These
  66. should have the same dimensions and be named 'swch1', 'swch2' ...
  67. Syntax: *IconZ2_Sprites <filename>
  68.  
  69. ==> Help on keyword IconZ2_Author
  70. Funky IconZ2 was created by David G Jones. If you have any comments then please get in contact:
  71.         160 Hazelwood Drive
  72.         St. Albans
  73.         Herts. AL4 0UZ
  74.         0727 - 852548
  75.  
  76.  
  77. —— Releases —————————————————————————————————————————————————————————
  78. 0.06 (09-Sep-94)  First release
  79.  
  80.  
  81. —— Public Domain ————————————————————————————————————————————————————
  82. The module is Public Domain. So do what you like with it. The set of animations are taken from the original Funky IconZ, which I think are PD. Note that animations from the original FunkyIconZ will need their sprites names changed to the "swch1" format.
  83.  
  84.  
  85. Any comments, etc please get in contact. If anyone creates a nice spinning
  86. Acorn, etc then please send me a copy.
  87.  
  88.     David G Jones
  89.     160 Hazelwood Drive
  90.     ST. ALBANS
  91.     Herts AL4 0UZ
  92.     0727 - 852 548
  93.     David.GJones@launchpad.unc.edu